home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / disk & file tools / cachefont / cachefont.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  7KB  |  174 lines
  1. @Database CacheFont.guide
  2. @Author "Adam Dawes"
  3. @(c) "Copyright 
  4.  1994 Adam Dawes"
  5. @$VER: CacheFont.guide 1.1 (25.9.94)
  6.         CacheFont / MakeFontList documentation -- AmigaGuide Format
  7. @node Main "CacheFont Documentation"
  8.                               CacheFont  v1.1
  9.                                By Adam Dawes
  10.                             25th September 1994
  11.                          @{" So what is CacheFont? " link WhatIs}
  12.                           @{" System Requirements " link Requirements}
  13.                                  @{" Usage " link Usage}
  14.                                 @{" Testing " link Testing}
  15.                               @{" Legal Stuff " link Legal}
  16.                                 @{" History  " link History}
  17.                          @{" Contacting the author " link Author} 
  18. @endnode
  19. @node WhatIs "What Is CacheFont?"
  20. CacheFont is a little utility that makes accessing your fonts significantly
  21. quicker -- in fact, near instant.
  22. I was always annoyed when using any programs on my Amiga which involved
  23. fonts by the fact that when the program went to see what fonts were
  24. available, I was presented with a rather lengthy wait. I decided I'd
  25. finally had enough of this, and it was time to do something about it.
  26. So after much poring over my keyboard and flicking through Amiga Intern, I
  27. finally came up with a solution. This utility comes in two parts:
  28.   CacheFont . . . . Installs or removes CacheFont (run it once to install
  29.                     the program, and a second time to remove it).
  30.   MakeFontList  . . This program must be run before CacheFont can be used.
  31.                     It creates the list of fonts that CacheFont will use
  32.                     later in order to avoid reading the whole font list
  33.                     again.
  34. CacheFont relies entirely on the files made by the MakeFontList utility. If
  35. your fonts directory is changed, CacheFont will *not* know anything about
  36. it unless you run MakeFontList afterwards. Even rebooting your machine
  37. won't change the list of fonts that CacheFont is aware of, so please run
  38. the MakeFontList utility every time you change your font directory. It
  39. takes only as long to run as a single font requester would've taken without
  40. CacheFont, and I think you'll agree that your font directory is changed
  41. much less often than you open a font requester!
  42. @endnode
  43. @node Requirements "System Requirements"
  44. CacheFont will only work on an Amiga with OS2 or greater. You don't need a
  45. harddrive, vast quantities of memory, or anything else.
  46. @endnode
  47. @node Usage "Usage"
  48. Using CacheFont
  49. ---------------
  50. CacheFont is installed simply by entering its command from the command
  51. line. It will print a message telling you that it has installed itself, and
  52. from then on all your font requesters will be running through the patch.
  53. If you wish to uninstall the patch, simply execute the command again and it
  54. will remove itself.
  55. The best way to install CacheFont is by including it in your
  56. startup-sequence or user-startup. This way, the patch will be initialised
  57. every time your system is booted.
  58. You do not need to 'run' the program as it returns control to your command
  59. line immediately.
  60. Using MakeFontList
  61. ------------------
  62. MakeFontList must be run in order for the CacheFont to function. It scans
  63. your Fonts: directory and stores the information needed by CacheFont in a
  64. directory (which will be created if necessary) called Fonts:CacheFontData/.
  65. If CacheFont has any difficulty reading these data files, it will display a
  66. requester asking you to run MakeFontList, and continue by using the
  67. original (slow) unpatched routine.
  68. You will need to run MakeFontList every time you make a change to your
  69. Fonts: directory. Don't include this command in your startup-sequence
  70. though! Call it manually whenever you need to.
  71. And how much disk space is wasted by the caching information files? Well I
  72. have 55 fonts installed at the moment, and the cache files come out to a
  73. whopping great 1581 bytes, hardly a great sacrifice. :)
  74. @endnode
  75. @node Testing "Testing"
  76. CacheFont has been tested without any problems on the following utilities:
  77.   AdPro 2.5
  78.   AmiQWK 2.5
  79.   Brilliance 2.0
  80.   CygnusEd Professional 3.5
  81.   DeluxePaint4
  82.   DeluxePaint4 AGA
  83.   Devpac 3.02
  84.   DirectoryOpus 4.12
  85.   Filer 3.1
  86.   Final Writer
  87.   Font Prefs V2.14
  88.   GoldEd 0.991
  89.   GP Fax 2.343
  90.   Infocom Task Force 1.55
  91.   MUI 2.2
  92.   NComm
  93.   Nicola 1-06
  94.   PageStream 3.0
  95.   Personal Fonts Maker 1.2
  96.   PowerPacker 4.0a
  97.   ProCalc 1.04
  98.   Q-Blue 1.0
  99.   ReqChange 2.01
  100.   Spot 1.3
  101.   SuperBase Pro4 1.01
  102.   Term 4.1
  103.   ToolManager 2.1
  104.   TurboText 1.03
  105.   Typesmith 2.02
  106.   Wordworth 3.0b
  107.   Workbench 'Font' preferences program
  108. CacheFont has been tested and works on the following computers:
  109.   A600
  110.   A1200
  111.   A1500
  112.   A3000
  113.   A4000/030
  114.   A4000/040
  115. ..it should work on any other computers without any problems (see
  116. @{"requirements" link Requirements}).
  117. @endnode
  118. @node Legal "Legal stuff"
  119. Ok, so my associates and I have tested this program as extensively as we
  120. can, and haven't found any bugs in it yet, but sod's law clearly dictates
  121. that the experiences of the many are worse than the experiences of the few.
  122. I won't accept responsibility for any damage done to your system or data
  123. lost, directly or indirectly, as a result from using CacheFont or any of
  124. its associated files. You use the program entirely at your own risk. Of
  125. course if you *do* experience problems then I'll do what I can to sort them
  126. out, and please let me know so that I can try to cure them in a future
  127. version of CacheFont.
  128. CacheFont and its associated files are not public domain. They may be
  129. distributed freely as long as no unreasonable charge is imposed. It may not
  130. be included within any commercial package without express written
  131. permission from the author; the exceptions from this are the AmiNet CDs and
  132. Fred Fish's utility collections. CacheFont and its associated utilities may
  133. only be distributed if all files contained within the original archive are
  134. present.
  135. @endnode
  136. @node History "History"
  137.  Version 1.0 (1/9/94)
  138.   o Initial release.
  139.   o Thanks to the following people for assistance in testing:
  140.         Nick Doyle
  141.         Jon Hudson
  142.         Lars Janssen
  143.         Roger Kille
  144.         Mark Stacey
  145.         Tim Still
  146.         Nicholas Wynne
  147.  Version 1.1 (25/9/94)
  148.   o CacheFont now understands Tagged font lists. This should keep it
  149.     working with most (if not *all*) of the programs that crashed version
  150.     1.0 (eg, FontPrefs by Martin Stengle). Note that CacheFont doesn't
  151.     actually return the tags at the moment, it always returns a null
  152.     pointer. Whilst this isn't entirely useful, it does stop crashes. My
  153.     thanks to Bret McGee for helping my find and solve this bug (aswell
  154.     as for some other very nice ideas which have yet to be implememted).
  155.   o Version strings are now Commodore Style-Guide compliant (thanks to
  156.     everyone who pointed that one out to me! :)
  157. @endnode
  158. @node Author "Contacting the author"
  159. Yes! Please do write to me if you like CacheFont or if you have any
  160. problems with it or suggestions for a new version. I can't promise to reply
  161. quickly if you write via snail-mail, but I will always reply to email
  162. messages. I can be contacted at:
  163.   InterNet
  164.      ad32@vms.bton.ac.uk
  165.   FidoNet
  166.      Adam Dawes@2:441/93.5
  167.   SnailMail
  168.      Adam Dawes
  169.      47 Friar Road
  170.      Brighton
  171.      BN1 6NH
  172.      England
  173. @endnode
  174.